home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / l_rmnd17.zip / LCG_RMND.DOC < prev    next >
Text File  |  1990-03-01  |  36KB  |  786 lines
  1. LCG/Remind version 1.7 
  2. Copyright 1989, 1990 by The Levin Consulting Group 
  3.  
  4.  
  5. Introduction 
  6. ------------
  7.  
  8.      LCG/Remind is a small utility program designed to remind you when it is 
  9. time to back-up the files on your hard disk, and to help automate the process.  
  10. We wrote this program for our clients, and have found that it is an excellent 
  11. way to ensure regular back-ups of valuable data.  In addition, it can be used 
  12. to display information, suggest action, or simply run any program on a regular 
  13. schedule.  It lets you ask multiple choice, or yes/no questions from within 
  14. your batch files. 
  15.  
  16.      Typically, you would call LCG/Remind from your AUTOEXEC.BAT file.  It 
  17. will determine when you last ran your back-up program, and, if it is time for a 
  18. new back-up, will display a message asking you whether to automatically run the 
  19. back-up. 
  20.  
  21.      Although there may be other programs similar to LCG/Remind, none are as 
  22. flexible, intelligent, or attractive: 
  23.      
  24.      o  LCG/Remind can determine when your disk was last backed-up by 
  25.         examining the date of "log" files created by your back-up software.  If 
  26.         your software doesn't create these, then they will be maintained by 
  27.         LCG/Remind. 
  28.  
  29.      o  The number of days before "triggering" the reminder message may be 
  30.         specified, or you can set it to trigger on specific days of the week, 
  31.         or specific days of the month. 
  32.  
  33.      o  You can set it to only trigger at a specified time of day. 
  34.  
  35.      o  Triggering can be initiated or prevented based on the total size of 
  36.         files that need to be backed-up, or the amount of free space on your 
  37.         hard disk. 
  38.  
  39.      o  The reminder message can be customized.  Foreign language support 
  40.         allows for Yes/No responses in any language.
  41.  
  42.      o  When triggered, the program can be instructed to take a variety of 
  43.         actions.  It can directly run another program.  It can simply display 
  44.         a reminder message.  Or, it can even offer a multiple-choice question, 
  45.         and act based on the response. 
  46.  
  47.      o  The name of the file containing the message can be specified on the 
  48.         command line, as can the file whose date is being examined.  This 
  49.         allows the program to be used to trigger a number of different events 
  50.         based on different date files.  For example, we have modified our 
  51.         autoexec.bat file so that our disk optimizing program is run once each 
  52.         day (even if we reboot multiple times).  If we haven't backed-up our 
  53.         hard disk in the past week LCG/Remind will ask us if we want to do so.  
  54.         Finally, every time we reboot we have LCG/Remind ask whether to load 
  55.         our print spooler. 
  56.  
  57. 2
  58.      o  LCG/Remind sets DOS "errorlevels" to reflect whether it was triggered 
  59.         and the answer to the question displayed.  This allows for maximum 
  60.         flexibility in system design, and absolute minimum memory use. 
  61.  
  62.      o  You can specify how long you want the message displayed, and your 
  63.         system will never hang, waiting for an answer.
  64.  
  65.      o  You can specify the color of the pop-up windows, their borders, and 
  66.         the title line.  LCG/Remind will work with any standard display 
  67.         system. 
  68.  
  69.      o  Try-before-you-buy ShareWare by a member of the Association of 
  70.         ShareWare Professionals.  Individual or corporate registration allows 
  71.         you to have your name (or your organization's) displayed on the title 
  72.         line, and to bypass the registration screen. 
  73.  
  74.  
  75. Revision History 
  76. ----------------
  77.  
  78. v 1.7 -- 3/1/90:    New disk full trigger (/df) and percent full substitution 
  79.                     (%p).  Added LAST day of month (/e:L), and specific week 
  80.                     of month (/w:X#) triggers.  Now displays exit code.  
  81.                     Improved 4DOS compatibility.  Added REMIND_2.BAT extended 
  82.                     example files.  Changed file names to conform to High 
  83.                     Sierra CD-ROM standard.  Minor bug fixes and documentation 
  84.                     changes.   
  85.  
  86. v 1.6 -- 9/11/89:   Speed up directory tree searches (/q).  Optional sound 
  87.                     effects (/ns).  Foreign language support with configurable 
  88.                     Yes/No keys (/y:).  Improved EGA/VGA support.
  89.  
  90. v 1.5 -- 6/29/89:   Can now use wildcards (i.e., /d:*.his) for date file 
  91.                     specification.  Added ability to trigger (/kt:) or prevent 
  92.                     (/kb:) backup based on the size of the files needing 
  93.                     backup (or matching any arbitrary filename pattern).  New 
  94.                     substitutions to put number (%f) and size (%k) of matching 
  95.                     files into the reminder message. 
  96.  
  97. v 1.4 -- 4/17/89:   Added optional config file (/f:), ability to wait until 
  98.                     specified time before continuing (/z:). 
  99.  
  100. v 1.3 -- 4/16/89:   Improved error trapping.  Updated documentation to 
  101.                     reflect ASP membership and PSL distribution. 
  102.  
  103. v 1.2 -- 3/19/89:   Time of day triggers (/tb:, and /ta:) added. 
  104.  
  105. v 1.1 -- 2/7/89:    Minor documentation changes and speed enhancements. 
  106.  
  107. v 1.0 -- 1/11/89:   First general release.  Added /n: switch, changed default 
  108.                     color scheme, minor bug fixes. 
  109.  
  110. v 0.2 -- 1/9/89:    Support for weekly (/w:) and monthly (/e:) triggers added.  
  111.                     Better window size error checking.  Added serial numbers. 
  112.  
  113. 3
  114. v 0.1 -- 1/5/89:    First beta test release shipped to Chicago. 
  115.  
  116.  
  117. Installation 
  118. ------------
  119.  
  120.      To install LCG/Remind simply copy the file lcg_rmnd.exe to a convenient 
  121. subdirectory on your hard disk.  Next, modify your autoexec.bat file.  For 
  122. example, if you want to trigger LCG/Remind every 7 days, and ask whether to do 
  123. a back-up, then include the following lines (which are also included in this 
  124. package as REMIND.BAT): 
  125.  
  126.         lcg_rmnd /i:7 
  127.         if errorlevel 3 goto :NOBACK 
  128.         if not errorlevel 2 goto :NOBACK 
  129.         rem Insert YOUR disk back up commands here 
  130.         lcg_rmnd /reset 
  131.         :NOBACK 
  132.  
  133.      This example uses the default lcg_rmnd.dat date file, and explicitly 
  134. resets the date if a back-up is run.  The "/i:7" command sets the interval to 
  135. 7 days.  If you want to see what LCG/Remind does when triggered, change the 
  136. switch to "/i:0".  That will trigger the program every time it is run.  If 
  137. your back-up program produces a file on your hard disk, then you can use a 
  138. simpler method, illustrated below.  Using this method, lcg_rmnd will always be 
  139. able to determine the date of your most recent back-up.  For example, we use 
  140. PC Tools version 5.5 PCBACKUP.EXE, which modifies a file called "PCBACKUP.HST" 
  141. (when "Report Option" is set to "Disk).  If you also use PC Tools, and want to 
  142. run a back-up every Monday without displaying a preliminary message, or asking 
  143. a question, you would place the following lines in your autoexec.bat: 
  144.  
  145.         lcg_rmnd /w:1 /n:3 /d:c:\pctools\pcbackup.hst /m: 
  146.         if errorlevel 1 pcbackup 
  147.  
  148.      The "/w:1" sets the trigger to every Monday, but "/n:3" will cancel the 
  149. trigger if a back-up has been performed in the preceding 3 days.  The "/m:" 
  150. switch without an attached file name instructs LCG/Remind NOT to display a 
  151. message.  Command line switches are described fully below, under the heading 
  152. "Command Line Syntax." 
  153.  
  154.      When creating your batch files, remember that MS-DOS requires that you 
  155. use the "call" command if you want to call one batch file from within another.  
  156. By itself, the batch file name will allow branching to the second batch file, 
  157. but will NOT return to the calling batch file. 
  158.  
  159.  
  160. Exit Codes 
  161. ----------
  162.  
  163.      LCG/Remind sets DOS exit codes.  These exit codes can be examined by a 
  164. parent process, or, through an ERRORLEVEL test in a DOS batch file.  Please 
  165. remember that the command "if errorlevel 3" is true if the errorlevel (exit 
  166. code) is GREATER THAN OR EQUAL to 3.  Thus, you should always test errorlevels 
  167. in descending order (i.e., 3,2,1). 
  168.  
  169.